home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / demos / lanmap / lanmap.doc < prev    next >
Text File  |  1996-07-10  |  25KB  |  495 lines
  1.  
  2.                          What is LANMAP?
  3.  
  4.         LANMAP is a Local Area Network utility program designed 
  5.      specifically for use with Novell networks.  The program is used 
  6.      to obtain a pictorial representation of the user area, combined 
  7.      with a graphic view of which user is logged onto each 
  8.      workstation.  
  9.  
  10.         Using the built-in editor, or any another text editor, the 
  11.      System Administrator can draw a map of the network, save it to 
  12.      disk, and instantly track real-time workstation use.  This can 
  13.      be useful for security monitoring, LAN use estimates, or finding 
  14.      which users are still logged on after hours or after a broadcast 
  15.      message to log off for system maintenance.
  16.  
  17.         LANMAP is very simple to use.  The main user menu is straight 
  18.      forward.  All program functions can be accessed from the menus, 
  19.      so command line options are not necessary, but they are 
  20.      available for those who prefer them.  The built-in editor is 
  21.      amply suited to design text maps.  It is not a full featured 
  22.      editor, but does include the ability to draw line graphics 
  23.      characters using the cursor keys if desired.  If the editor is 
  24.      not adequate for some use, then any text editor may be used to 
  25.      create an ASCII map file.
  26.  
  27.  
  28.                            How to Install LANMAP
  29.  
  30.         LANMAP can be installed on any hard disk, floppy disk, or 
  31.      network drive by using the normal DOS COPY command, or the 
  32.      Netware equivalent NCOPY command.  The following set of 
  33.      instructions will install LANMAP under the PUBLIC subdirectory.  
  34.      Here we are assuming that SYS:PUBLIC is mapped to the Z: drive, 
  35.      as this is the default mapping for Netware.  If this is not the 
  36.      case, or you do not wish to install LANMAP in the PUBLIC 
  37.      directory, then simply substitute the appropriate drive letter 
  38.      for your case.  Each command is followed by pressing the <enter> 
  39.      key.
  40.  
  41.      1)  Make SYS:PUBLIC the default drive.  Type Z:
  42.  
  43.      2)  Copy the LANMAP files into PUBLIC.  Type NCOPY A:*.* Z:*.*
  44.  
  45.      3)  Make LANMAP a read-only file.  Type FLAG Z:LANMAP.COM SRO
  46.  
  47.      4)  Make NETLIST a read-only file.  Type FLAG Z:NETLIST.COM SRO
  48.  
  49.        The LANMAP files are now installed in the PUBLIC directory.
  50.  
  51.                              How to Run LANMAP
  52.  
  53.         LANMAP is invoked by typing LANMAP at the DOS prompt and 
  54.      pressing <enter>.  From here on the program options are selected 
  55.      via the main menu, which appears on the opening screen.  Also 
  56.      displayed on the opening screen is the name of the Active Map 
  57.      File and the program credits, including the version number and 
  58.      the copyright notice.  (Command line options are discussed at 
  59.      the end of this document.)
  60.  
  61.         In the upper left corner of the opening screen will be a 
  62.      message stating what the name of the Active Map file is.  This 
  63.      is the file that will be loaded for editing or displaying.  If 
  64.      there is no Active Map file, then this will be stated.
  65.  
  66.         On the bottom line of the screen is the credit line.  This 
  67.      line states the version number and contains the copyright 
  68.      notice.
  69.  
  70.         In the center of the screen is the main menu.  This is a list 
  71.      of four options surrounded by a box.  One of the choices will be 
  72.      highlighted.  To highlight a different option, press the up or 
  73.      down arrow keys.  To select the highlighted option, press the 
  74.      <enter> key.
  75.  
  76.         Choosing "EXIT" will terminate the LANMAP program.
  77.  
  78.         Choosing "Display LAN Map" will cause LANMAP to load the 
  79.      Active Map file from disk, display the file on the screen, 
  80.      examine it for node information, begin polling the network for 
  81.      active nodes, and display user information on the displayed map.  
  82.      If no Active Map file is defined, then a message will be 
  83.      displayed which states that "You must specify a Map to display 
  84.      or edit."  Pressing a key will return you to the opening screen 
  85.      and the main menu.
  86.  
  87.         Choosing "Edit a Map File"  will cause LANMAP to load the 
  88.      Active Map file from disk and display the first screen full.  It 
  89.      then accepts further user input as text which is added to the 
  90.      map.  The editor itself will be explained later.  If no Active 
  91.      Map file is defined, then a message will be displayed which 
  92.      states that "You must specify a Map to display or edit."  
  93.      Pressing a key will return you to the opening screen and the 
  94.      main menu.
  95.  
  96.         Choosing "Select a new Map" will cause LANMAP to ask two 
  97.      questions.  First, you are asked "Which drive letter contains 
  98.      the MAP file?"  The current default drive letter will be 
  99.      displayed.  If this drive designator is correct, then simply 
  100.      press <enter>, otherwise type the drive letter which contains 
  101.      the Map file you wish to access.  You do not need to type the 
  102.      colon, although you may if you wish.  Note that only a drive 
  103.      letter may be specified; no PATH is allowed.  The subdirectory 
  104.      that contains the Map files should be assigned to a drive letter 
  105.      with the Netware MAP command.  For instance, if the Map files 
  106.      are contained in the PUBLIC subdirectory, then before starting 
  107.      LANMAP you should have typed a command similar to the following: 
  108.      MAP Z:=SYS:PUBLIC.  Then, when asked to enter the drive letter 
  109.      you need only type Z and press <enter>.  
  110.  
  111.         Second, you are asked "What is the name of the MAP file?"  
  112.      Here you should type the name of the Map file which you wish to 
  113.      use.  Type the file name in the form FILENAME.EXT (any legal DOS 
  114.      file name is allowed).  If the named file does not exist, then 
  115.      it will be created.  If no file is specified, then a message to 
  116.      that effect will be displayed, and pressing any key will return 
  117.      you to the opening screen.  If an existing file name is 
  118.      specified, then you will return to the opening screen and the 
  119.      new Active Map file will be indicated in the upper left corner 
  120.      of the screen.
  121.  
  122.        If you wish to set a default file name, LANMAP will read the 
  123.      default Map file name from the DOS ENVIRONMENT area.  For 
  124.      instance, if your Map file is called LANMAP.MAP, then at the DOS 
  125.      prompt type SET LANMAP=LANMAP.MAP to create the default.  Then, 
  126.      when prompted for the file name, LANMAP.MAP will appear in the 
  127.      file name space and you can simply press the <enter> key to 
  128.      select the default.  This SET command can be placed in the 
  129.      AUTOEXEC.BAT file if desired.
  130.  
  131.  
  132.                              Using the Editor
  133.  
  134.         The editor included with LANMAP is functional but not fancy.  
  135.      It is used to edit plain ASCII text files which LANMAP will load 
  136.      and process as Map files.  If you have a favorite editor, or 
  137.      require sophisticated editing features, then any text editor 
  138.      which can produce ASCII files will be appropriate for making Map 
  139.      files.  Note that any line which is over 80 characters will be 
  140.      truncated to 80 characters.  Each Map file may be a maximum of 
  141.      250 lines long.  If you create a Map file longer than 250 lines, 
  142.      the excess lines will be ignored when the Map is loaded.
  143.  
  144.         The bottom line of the screen displays the status line.  This 
  145.      line shows the CsrGrph indicator, the cursor line, the cursor 
  146.      column, the editor function, and the name of the Map file.
  147.  
  148.         The CsrGrph indicator, if on, shows that pressing cursor 
  149.      arrow keys will display graphics line characters in addition to 
  150.      moving the cursor.  To toggle CsrGrph on and off, press ^G (hold 
  151.      down the <ctrl> key and press the G key at the same time).  The 
  152.      graphics line characters can be used to show walls, hallways, or 
  153.      cubicle boundaries.  Only vertical and horizontal line segments 
  154.      are available, the corner segments cannot be produced.
  155.  
  156.         The cursor line and cursor column indicate which line and 
  157.      column of the Map file the cursor is located on.  This is the 
  158.      place that the next typed character will appear.
  159.  
  160.         The editor function indicates what the editor is currently 
  161.      doing.  Normally this will read "Edit."  During a file save it 
  162.      will read "Save" and while quitting (abandoning a file) it will 
  163.      read "Quit."
  164.  
  165.  
  166.                          Saving an edited Map file
  167.  
  168.         When done editing a Map file, press ^S three times in a row 
  169.      (hold down the <ctrl> key while typing S three times).  This 
  170.      will cause the Map file to be saved on disk.
  171.  
  172.  
  173.                        Abandoning an edited Map file
  174.  
  175.         If you have made changes to a Map file, and decide that you 
  176.      don't like them, you may exit the editor without saving your 
  177.      work.  This is done by pressing ^Q three times in a row (hold 
  178.      down the <ctrl> key while typing Q three times).
  179.  
  180.  
  181.                               Cursor movement
  182.  
  183.         The cursor may be moved by using the Tab key, the cursor 
  184.      (arrow) keys, the <enter> key, the Home, End, PgUp, and PgDn 
  185.      keys.  The only key that will move the cursor past the current 
  186.      end of file (add lines to the file) is the <enter> key.  Once 
  187.      line 250 is reached, no more lines can be added and the cursor 
  188.      will not move any further.
  189.  
  190.  
  191.                           Adding text/characters
  192.  
  193.         To add a character to the Map, simply type that character.  
  194.      It will become part of the Map at the current cursor position.  
  195.      There is no insert mode.  To delete a character, you may either 
  196.      backspace over it, or type a space over it.  The Del key does 
  197.      not delete characters.  To add more lines to the bottom of a 
  198.      Map, use the <enter> key.
  199.  
  200.  
  201.                     Adding Workstation Nodes to the Map
  202.  
  203.         Since this program is used to display the user name 
  204.      associated with each active node on the network, the most 
  205.      important information on every Map is the node information.  
  206.      Each node is identified by typing its PHYSICAL address enclosed 
  207.      in curly brackets "{}."  When LANMAP first loads a Map file for 
  208.      display, it searches for information enclosed in {} and assumes 
  209.      that this information is a physical node address.  A physical 
  210.      node address is that hexadecimal address which is either 
  211.      permanently burned into the network interface card, or set with 
  212.      DIP switches at installation time.  Either way, each card on the 
  213.      network MUST have a unique physical address.
  214.  
  215.         If you have multiple networks which are bridged either 
  216.      internally or externally, it is possible to have two Physical 
  217.      Addresses which appear to be the same.  In fact, the Physical 
  218.      Address consists of both the Network Interface Card's address, 
  219.      and the Inter-network address.  For instance, if you have two 
  220.      separate Proteon ProNet networks joined by a Novell supported 
  221.      X.25 external bridge (or internal bridging for that matter), it 
  222.      is possible to have duplicate Physical addresses set on two of 
  223.      the Proteon network interface cards.  However, each network has 
  224.      an Inter-network address, which was specified when the Netware 
  225.      Operating System was Genned (When GENOS was run).  In this case, 
  226.      node addresses should be specified by both the physical address 
  227.      and the inter-network address enclosed in curly brackets "{}" 
  228.      and separated by a slash "/".  (i.e. {10/F} for a physical 
  229.      address of 10 and an inter-network address of F).
  230.  
  231.         Other network topology/bridge combinations can also produce 
  232.      situations where it is necessary to specify both the physical 
  233.      address and the inter-network address of each workstation.  The 
  234.      above is just one example.  
  235.  
  236.         It should be noted that networks without bridges will not 
  237.      require an inter-network address to be specified.  Only in 
  238.      instances where there are two or more network addresses present 
  239.      will an inter-network address need to be specified.
  240.  
  241.         If a node address is specified without an inter-network 
  242.      address, the inter-network address of the network the 
  243.      workstation running LanMap is on will be used.
  244.  
  245.         With the Novell S/Net network, the physical address is 
  246.      directly related to which port the network interface card is 
  247.      attached to.  Please note that a node's physical address has no 
  248.      relation to its logical station address.  The logical station is 
  249.      the number that appears when you use the Netware USERLIST 
  250.      command.
  251.  
  252.         When alphanumeric characters appear in a hexadecimal address, 
  253.      uppercase characters must be used.  Following are some examples 
  254.      of physical addresses as they should be specified in the Map 
  255.      files.
  256.  
  257.                     IBM Token Ring:     {10005A0069CF}  where the 
  258.                     last six characters can change with each card.  
  259.                     These addresses are burned into each Token Ring 
  260.                     card by IBM at manufacturing time.
  261.  
  262.                     Novell S/Net:       {1} ... {A} ... {18} are 
  263.                     valid values, where {1} corresponds to port 1, 
  264.                     {A} to port 10, and {18} to port 24.  These ports 
  265.                     are located on the back of the 68B file servers.
  266.  
  267.                     Gateway G-net:      {1} ... {FF} are valid 
  268.                     values.  These values are set via DIP switches at 
  269.                     installation time.
  270.  
  271.                     Ethernet: These addresses are burned into each 
  272.                     card at manufacturing time.
  273.  
  274.                     Proteon ProNet: {1} ... {FF} are valid values.  
  275.                     These values are set via DIP switches at 
  276.                     installation time.
  277.  
  278.                     Novell S/Net (Multiple Servers): {1/1}, {A/FF}, 
  279.                     and {14/8} are examples of valid values.  In the 
  280.                     first case, 1 is the workstation physical ID, and 
  281.                     1 is the internetwork address.  In the second 
  282.                     case, A is the workstation physical ID, and FF is 
  283.                     the internetwork address.
  284.  
  285.      A list of active physical nodes can be obtained using the 
  286.      NETLIST utility included on the original LANMAP diskette.  At 
  287.      the DOS prompt, type NETLIST and press <enter>.  A listing of 
  288.      each attached file server will appear, along with a listing of 
  289.      each user logged in and that user's physical node address, 
  290.      including the inter-network address.  Enter these addresses in 
  291.      the Map file.  
  292.  
  293.      You can redirect the NETLIST output to a DOS file by typing 
  294.      NETLIST > FILENAME.EXT
  295.  
  296.      You can redirect the NETLIST output to the printer by typing 
  297.      NETLIST > LPT1:
  298.  
  299.         A sample Map is contained in the file SAMPLE.MAP.
  300.  
  301.  
  302.                             The DISPLAY Option
  303.  
  304.         When you choose the Display LAN Map option from the main 
  305.      menu, the Active Map file will be loaded from disk, the first 
  306.      page will be displayed, and the entire map will be scanned for 
  307.      nodes.  Remember that a node is any text enclosed in "{}."  
  308.      After the nodes are found, they will be highlighted on the 
  309.      screen.  On a color monitor, they will be displayed as brown 
  310.      characters.  On a monochrome monitor, they will be displayed as 
  311.      normal intensity characters.  The inter-network portion of a 
  312.      node address will not be highlighted.  On a color monitor they 
  313.      will be displayed green, and on a monochrome monitor they will 
  314.      be displayed at normal intensity.
  315.  
  316.         From this point on, at regular intervals, LANMAP will poll 
  317.      the network for active nodes.  The login name of each user on 
  318.      the LAN will be displayed in place of the physical node address.  
  319.      Accompanying each login name will be the network station ID of 
  320.      that node.  Login names for users who are logged in to LANMAP's 
  321.      default server will be displayed in yellow on a color monitor 
  322.      (high intensity on a monochrome monitor) while users who are 
  323.      logged in to other servers on the same network will be displayed 
  324.      in brown (normal intensity on a monochrome monitor).  The 
  325.      station that is currently being used to run LANMAP will be 
  326.      displayed in blinking characters.  To exit the Display option, 
  327.      simply press the <enter> key.  If a password has been set, then 
  328.      you must enter it to exit Display mode.  You have one minute to 
  329.      enter the correct password.  If one minute passes, or the 
  330.      incorrect password in entered, then Display will resume.
  331.  
  332.         Both LANMAP and NETLIST will recognize multiple servers on a 
  333.      single network, and all the users logged into those servers.  
  334.      NETLIST will recognize eight (8) attached servers, which is the 
  335.      maximum allowed by Novell.  LANMAP will also recognize eight (8) 
  336.      attached servers, and currently a maximum of 255 users.  
  337.      However, for either program to see a file server, the work 
  338.      station running the program must be previously attached to that 
  339.      server either by the LOGIN or the ATTACH command.  For example, 
  340.      if there are three file servers on a network, called FS1, FS2, 
  341.      and FS3, the user should type something similar to the following 
  342.      before running LANMAP or NETLIST:
  343.  
  344.         LOGIN FS1/username
  345.         ATTACH FS2/username
  346.         ATTACH FS3/username.
  347.  
  348.  
  349.      The "Logging" Suboption
  350.  
  351.         LANMAP has the ability to keep a running record of how many 
  352.      users are logged into the different file servers during the time 
  353.      it is running in the Display mode.  To activate Logging, press 
  354.      the 'L' key (upper or lower case).  You will be presented with a 
  355.      screen telling you which logged drive the files will be kept on, 
  356.      and what the file names will be.  The drive will be the same one 
  357.      on which the Map file is located (make sure you have 
  358.      Write/Create access to that directory), and the file names will 
  359.      be made out of the first eight characters of the File Server 
  360.      names with an extension of .USE.  You will then be asked if you 
  361.      wish to start logging - Press the 'Y' or the 'N' key to answer 
  362.      the question.  There is no default answer, the 'Y' or 'N' that 
  363.      appears after the question is there to tell you the current 
  364.      state of the Logging operation.
  365.  
  366.         If you press 'Y', you will be asked to enter a logging 
  367.      interval.  The value you enter specifies in how often in minutes 
  368.      the logging statistics will be written.  Only values between 1 
  369.      and 30 minutes are legal.  Each time the specified interval 
  370.      expires, a record will be written to the appropriate file for 
  371.      each file server.  The record will consist of the date, time and 
  372.      number of users logged in.
  373.  
  374.         You have no control over which disk (directory) is used, or 
  375.      what the file names are.  You only have control over whether or 
  376.      not logging is active, and the logging time interval.
  377.  
  378.  
  379.      The "Password" Suboption
  380.  
  381.         The person running the LANMAP application can choose to set a 
  382.      password which is required before LANMAP will terminate the 
  383.      Display option.  In this way, some unknown assailant will be 
  384.      unable to deactivate LANMAP if it is left running unattended.  
  385.      To invoke the Password option, Press the 'P' key (upper or lower 
  386.      case).  The screen will be cleared, and a series of passwords 
  387.      will have to be entered.  The password is only in effect until 
  388.      LANMAP is EXITed.  Each time the program is run, the password 
  389.      suboption must be re-invoked.
  390.  
  391.         If there is already a current password installed, then you 
  392.      must first enter it in order to change the current one.  You 
  393.      will be prompted to do so.  If you enter the incorrect password, 
  394.      then you will be returned to the Display function.  If you enter 
  395.      the correct password, then you will be given the opportunity to 
  396.      change current password.
  397.  
  398.        If there is no current password, or you correctly enter the 
  399.      current password, then you will be prompted to enter a new 
  400.      password.  After you either enter eight (8) characters, or press 
  401.      <enter>, you will be prompted to re-type the same password.  If 
  402.      you re-type it successfully, then the password will be changed.  
  403.      If not, then you must go back and start from the new password 
  404.      again.
  405.  
  406.         A password is any sequence of up to eight character-producing 
  407.      keystrokes.  If you wish a password shorter than eight 
  408.      characters, then it should be terminated with the <enter> key.  
  409.      Just realize that EVERY keystroke counts as part of the 
  410.      password, even the <enter> key.  Below are some examples of 
  411.      different passwords possible:
  412.  
  413.           duckling
  414.           DuCkLiNg
  415.           DUCKLING
  416.           <F2><esc><Home><enter>
  417.           mush<enter>
  418.           ^Z^Z<PgDn><enter>
  419.  
  420.         If you forget the password that you typed, you are out of 
  421.      luck.  There is no way to find out what it is, and you must re-
  422.      boot the PC in order to make LANMAP stop running.
  423.  
  424.  
  425.      The "Server" Suboption
  426.  
  427.         As stated before, login names which are attached to LANMAP's 
  428.      default server are displayed in yellow (or high intensity).  To 
  429.      cause a different set of names to be highlighted, you must 
  430.      change LANMAP's default server.  One way to do this is to exit 
  431.      the LANMAP program and use Netware to change servers.  The other 
  432.      way is to press the 'S' key (upper or lower case) to bring up 
  433.      the list of currently attached file servers.  The current 
  434.      default file server will be highlighted.  By pressing the up and 
  435.      down arrow keys to highlight another server, and pressing the 
  436.      Enter key to select the desired server, you can select a new 
  437.      current default file server.  Note that when one workstation is 
  438.      logged into multiple servers under more than one name, the name 
  439.      which is being used on the current server will be displayed.  If 
  440.      a user is not attached to the current server, then one of the 
  441.      other login names will be displayed.  When you exit LANMAP, the 
  442.      default server will be restored to the default server in effect 
  443.      when LANMAP was started.
  444.  
  445.  
  446.      The "User search" Suboption
  447.  
  448.         Suppose you want to know where a particular user is logged 
  449.      on, but your Map is somewhat lengthy and you don't want to 
  450.      scroll through it.  To accomplish this you may invoke the User 
  451.      search suboption.  To do this, press the 'U' key (upper or lower 
  452.      case).  You will be presented with a screen which asks you to 
  453.      enter the Login name of the user for whom you wish to search.
  454.  
  455.         If that user can be located on any screen AFTER the one 
  456.      currently being displayed, then two things will happen.  First, 
  457.      you will be told how many times that user occurs, second you 
  458.      will be brought to that screen immediately.  If possible, that 
  459.      user's node will be displayed on the middle line of the screen.  
  460.      Note that only screens AFTER the current one are searched, so it 
  461.      might be a good idea to use this option from the top of the Map.
  462.  
  463.  
  464.                            Command Line Options
  465.  
  466.         If you desire, LanMap can be started with many options 
  467.      specified by a combination of the DOS environment and the 
  468.      command line.  This is intended to help you run LanMap 
  469.      unattended, for example, from an AUTOEXEC.BAT of during System 
  470.      Login.  For an explanation of how to set a default Map filename, 
  471.      see "How to Run LanMap," under the "Select a New Map" section.  
  472.      The form of the LanMap command follows:
  473.  
  474.      LANMAP [/P=xxxxxxxx] [/L=nn] [/AUTO=YES]
  475.  
  476.      Each of the items in square brackets is optional.  The options 
  477.      may be entered in lower or upper case.  
  478.  
  479.      /P=xxxxxxxx is used to specify the Password.  Upper/Lower case 
  480.      is respected.  Up to 8 characters will be recognized.
  481.  
  482.      /L=nn is used to specify a Logging interval, and at the same 
  483.      time turn Logging on.  Only values of 1 to 30 are allowed.  If 
  484.      values outside this range are entered, then 15 will be used.  If 
  485.      illegal characters (non-digits) are entered, then 15 will be 
  486.      used.
  487.  
  488.      /AUTO=YES is used to tell LanMap to autostart.  This means that 
  489.      it does not stop at the main menu, but rather assumes the 
  490.      default disk drive, reads the default Map filename from the DOS 
  491.      environment, and runs the "Display LAN Map" option.  If 
  492.      /P=xxxxxxxx was specified, then xxxxxxxx becomes the Exit 
  493.      Password.  If /L=nn was specified, then usage logging will take 
  494.      place every nn minutes.  The word "yes" may be upper or lower 
  495.      case, but ALL letters must be upper or lower case, not mixed.